package com.telecom.mapper;

import com.telecom.pojo.entity.User;
import com.telecom.pojo.vo.admin.user.UserPageVO;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import org.apache.ibatis.annotations.Select;

import java.util.List;

/**
 * <p>
 * 用户表 Mapper 接口
 * </p>
 *
 * @author GWX.cz
 * @since 2025-07-31
 */
@Mapper
public interface UserMapper {

    @Select("select * from user where username = #{username}")
    User findByUsername(String username);

    @Select("select * from user where id = #{userId}")
    User selectById(Long userId);
    
    /**
     * 根据ID更新用户信息
     * 
     * @param user 用户信息
     * @return 更新的行数
     */
    int updateById(User user);

    // ==================== 管理端方法 ====================
    
    /**
     * 用户分页查询（配合PageHelper使用）
     * 
     * @param idOrUsername 用户ID或用户名（可选）
     * @return 用户列表
     */
    List<UserPageVO> selectUserPage(@Param("idOrUsername") String idOrUsername);
    
    // ==================== 工作台统计方法 ====================
    
    /**
     * 统计注册用户总数
     * 
     * @return 用户总数
     */
    @Select("SELECT COUNT(*) FROM user where role = 0")
    Integer countTotalUsers();
}
